argh-amp
by Andy Dufilie

Sections:

Getting started
Keyboard Shortcuts
GUI Editor
Sharing Skins
Skin modifications
Website

Getting started

How to install

This script requires mIRC v6.03 or newer. The newest version of mIRC is available here.

If you put aamp.mrc in the same directory as mIRC.exe, then type the following in mIRC:
  /load -rs aamp.mrc

If the file is in another directory, then type:
  /load -rs "C:\path\to\aamp.mrc"

If you install mp3stuff also, there will be an option in the argh-amp popup to integrate with mp3stuff (unloading stuffamp is recommended).


The "/aamp" command

To start the player, type /aamp
If you want to pick a skin in your .skn file, use /aamp <number>
To load the default skin, use /aamp 0
To load a skin that someone wants to share with you, use /aamp <skin definition>


Playlist controls

Most of the playlist controls can be found in the popup menu. Right-click in the player window and click the playlist submenu.
To change the order of files in the playlist, select the files and drag the mouse to where you want them.
To select multiple files with the mouse, hold SHIFT while clicking.
To toggle the selection of a single entry, hold CTRL and click on the song.
To select all files press CTRL+A.
To remove files, select them and press the DELETE key.


[Back to top]


Keyboard Shortcuts

Player controls:

FunctionShortcut key
PrevZ
PlayX
PauseC
StopV
NextB
EjectL
Change volumeUP
DOWN
Go back 5 secondsLEFT
Skip ahead 5 secondsRIGHT
Open an mp3O
Open playlistP


Playlist controls:

FunctionShortcut key
Scroll through playlistCTRL+PGUP
CTRL+PGDN
PGUP
PGDN
HOME
END
Change selectionUP
DOWN
Play selected fileENTER
Move selected filesCTRL+UP
CTRL+DOWN
Select allCTRL+A
Remove selected filesDELETE


Skin related shortcuts:

FunctionShortcut key
Copy skin to clipboardCTRL+C
Load skin from clipboardS
Reload saved skinCTRL+R
Delete saved skinCTRL+DELETE
Open GUI EditorCTRL+E
Change entire skinKey pairs:
'[', ']'
'U', 'I'
'-', '='
'-', '+'
Change colors onlyKey pairs:
SHIFT '[', SHIFT ']'
SHIFT 'U', SHIFT 'I'
SHIFT '-', SHIFT '='
SHIFT '-', SHIFT '+'
Change layout onlyKey pairs:
CTRL '[', CTRL ']'
CTRL 'U', CTRL 'I'
CTRL '-', CTRL '='
CTRL '-', CTRL '+'


[Back to top]


GUI Editor
To open the GUI Editor, select "Skin -> GUI Editor" in the popup.

Types of lines in the GUI Editor window

Player controls
Titlebar text
Fonts
Options
Colors


Moving controls

To move parts of the layout, select the lines you want to edit, then drag the mouse on the player window.
Note that if you don't want certain controls on the window, you can just move them out of sight.


Changing width & height of controls

To change width and height of controls, hold the SHIFT key while dragging the mouse.
NOTE: There is nothing that prevents you from making controls have negative size, so if you make it ugly, it's your own fault. =)


Volume & position bars can be horizontal or vertical

Both bars can be either horizontal or vertical.
To make one vertical, just make it taller than it is wide, and vice versa for horizontal.


Volume & position bar knobs

To change width and height of a knob, hold the CTRL key while dragging the mouse.


Arrow keys nudge controls

You can use the arrow keys instead of the mouse to nudge controls by 1 pixel.
The player window must be active for this to work. This means you must click on the window before using the arrow keys.
SHIFT and CTRL are also supported when using the arrow keys.


Saving your work

To save your work, right-click in either the player window or the editor window, and select "Skin -> Save."
This will save a copy of the current skin without overwriting any existing skin.


Undoing changes

To drop all changes and revert to a saved skin, select "Skin -> Reload saved skin" in the popup.


Deleting saved skins

To delete unwanted skins, simply right-click in the player window after loading the unwanted skin, and click on "Skin -> Delete saved skin."


Player controls

You can edit the positions & sizes as described above.

LineDescription
Width/HeightWidth and height of main window
TitlebarPosition & size of titlebar
MinimizePosition & size of "Minimize" button
ClosePosition & size of "Close" button
PrevPosition & size of "Previous mp3" button
PlayPosition & size of "Play" button
PausePosition & size of "Pause" button
StopPosition & size of "Stop" button
NextPosition & size of "Next mp3" button
EjectPosition & size of "Eject" button
SongPosition & size of song title display
TimePosition & size of time display
kbpsPosition & size of kbps display
kHzPosition & size of kHz display
VolumePosition & size of volume bar (and size of knob, editable with CTRL)
Position-barPosition & size of position bar (and size of knob, editable with CTRL)


Titlebar text

Click once on these lines to edit the text.

LineDescription
Text.TitlebarText to display in the titlebar (can be blank)
Text.PL-TitlebarText to display in the playlist titlebar (can be blank)


Fonts

Click once on these lines to edit the font face or font size.

LineDescription
Font.TitlebarFont for titlebar
FontSize.TitlebarFont size for titlebar
Font.SongFont for song title
FontSize.SongFont size for song title
Font.TimeFont for time display
FontSize.TimeFont size for time display
Font.QualityFont for kbps and kHz
FontSize.QualityFont size for kbps and kHz
Font.PlaylistFont for playlist entries
FontSize.PlaylistFont size for playlist entries


Options

Click once on these lines to cycle through the different modes.

LineDescription
Option.Title-position0 = Left-align titlebar text
1 = Center titlebar text
2 = Right-align titlebar text
Option.PL-Title-position0 = Left-align playlist titlebar text
1 = Center titlebar text
Option.Main-Border0 = No border around main window
1 = Draw border around main window
Option.Alt-BordersSelects alternate borders for buttons, edits, etc.
Option.Label-Move1 = Labels move when buttons are pressed
0 = Labels don't move
Option.Knob-Border0 = No border around knobs
1 = Draw border around knobs


Colors

Click on these lines to change the RGB value.

You can enter any of three formats for RGB colors:
    - R,G,B decimal
    - A single number
    - 6-digit #RRGGBB hexadecimal (# required)

LineDescription
Color.MainMain window color
Color.Hilight(1)Border color (Example: white)
Color.3DLight(2)Border color (Example: light gray)
Color.Shadow(3)Border color (Example: dark gray)
Color.Frame(4)Border color (Example: black)
Color.TitlebarActive titlebar color
Color.Titlebar2Inactive titlebar color
Color.Titlebar-TextActive titlebar text color
Color.Titlebar-Text2Inactive titlebar text color
Color.ButtonButton face color
Color.Button2Button face color when pressed
Color.Button-LabelButton label color
Color.Button-Label2Button label color when pressed
Color.EditBackground color for song title, time display,
kbps, kHz, Volume, and Position-bar
Color.SongColor of the song title
Color.TimeColor of the time display
Color.QualityColor of the kbps and kHz text
Color.KnobColor of the knob on Volume and Pos-bar
Color.PL-EditBackground for playlist entries
Color.PL-Edit2Background for selected playlist entries
Color.PL-textText color for playlist entries
Color.PL-text2Text color for mp3 currently playing
Color.PL-barColor of scrollbar
Color.PL-bar2Color of clicked scrollbar
Color.PL-KnobColor of scrollbar knob


[Back to top]


Sharing Skins

To share skins with your friends on IRC, right-click in the argh-amp window and click on "Skin -> Copy to clipboard."
Paste it into mIRC, and your friends can type "/aamp <what you pasted>" to view the skin.
They can then save the skin by right-clicking in the argh-amp window and selecting "Save."

You can also use shortcut keys to copy and load skins.

[Back to top]


Skin modifications

The "/aamp.mod" command:

CommandEffect
/aamp.mod doubleDouble the layout size
/aamp.mod scale <scale>Scale the layout (.5 = half, 1 = no effect, 2 = double, etc.)
/aamp.mod flipvFlip the layout vertically
/aamp.mod fliphFlip the layout horizontally
/aamp.mod rotateRotate RGB values of all colors (R -> G, G -> B, B -> R)
/aamp.mod swapSwap red and green values of all colors
/aamp.mod grayConvert all colors to grayscale
/aamp.mod invertInvert all colors
/aamp.mod gamma <increment>Change brightness of all colors
/aamp.mod red <increment>Modify the red component of non-grayscale colors
/aamp.mod green <increment>Modify the green component of non-grayscale colors
/aamp.mod blue <increment>Modify the blue component of non-grayscale colors
/aamp.mod red+ <increment>Modify the red component of all colors
/aamp.mod green+ <increment>Modify the green component of all colors
/aamp.mod blue+ <increment>Modify the blue component of all colors


[Back to top]


Website

http://pages.cthome.net/pdufilie/

[Back to top]